Metrics

Este documento define as métricas que a API Reporting do YouTube recupera. Essa API recupera relatórios de dados em massa que contêm dados do YouTube Analytics para um proprietário de conteúdo ou canal.

As métricas são medições individuais da atividade do usuário, do desempenho do anúncio ou da receita estimada. As métricas de atividade do usuário incluem coisas como contagem de visualizações de vídeo e classificações (marcações "gostei" e "não gostei").

Métricas principais

Embora a API YouTube Reporting esteja sujeita à política de descontinuação definida nos Termos de Serviço, as métricas e dimensões secundárias não estão sujeitas a ela. Nas definições desta página, qualquer métrica principal é identificada explicitamente como tal.

A lista abaixo identifica as principais métricas da API. Qualquer uma dessas métricas que também são usadas na API YouTube Analytics são métricas principais nessa API.

Consulte a lista de APIs do YouTube sujeitas à política de descontinuação para mais informações.

Ver métricas

engaged_views (métrica principal)
O número de vezes que o vídeo foi assistido por pelo menos 4 segundos.
visualizações (métrica principal)
O número de vezes que um vídeo foi visualizado. Em um relatório de playlist, a métrica indica o número de vezes que um vídeo foi assistido no contexto de uma playlist. A Central de Ajuda do YouTube oferece mais informações sobre como as visualizações são denunciadas. This is a core metric and is subject to the Deprecation Policy.
red_views
O número de vezes que um vídeo foi visualizado por assinantes do YouTube Premium (antes conhecido como YouTube Red).
views_percentage (métrica principal)
A porcentagem de espectadores que estavam conectados ao assistir o vídeo ou a playlist. This is a core metric and is subject to the Deprecation Policy.

Métricas de tempo de exibição

watch_time_minutes (métrica principal)
O número de minutos que os usuários assistiram vídeos do canal, proprietário de conteúdo, vídeo ou playlist especificado. This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
O número de minutos que os assinantes do YouTube Premium (antes conhecido como YouTube Red) assistiram a um vídeo.
average_view_duration_seconds (métrica principal)
A duração média, em segundos, das reproduções de vídeo. A partir de 13 de dezembro de 2021, essa métrica exclui o tráfego de clipes em loop. Em um Relatório de playlist, a métrica indica a duração média, em segundos, das reproduções de vídeo que ocorreram no contexto de uma playlist. This is a core metric and is subject to the Deprecation Policy.
average_view_duration_percentage
A porcentagem média de um vídeo assistido durante a reprodução. A partir de 13 de dezembro de 2021, essa métrica exclui o tráfego de clipes em loop.

Métricas de engajamento

comentários (métrica principal)
O número de vezes que os usuários comentaram em um vídeo. Confira mais informações na Central de Ajuda do YouTube. This is a core metric and is subject to the Deprecation Policy.
likes (métrica principal)
O número de vezes que os usuários indicaram que gostaram de um vídeo atribuindo uma classificação positiva. This is a core metric and is subject to the Deprecation Policy.
desgostos (métrica principal)
O número de vezes que os usuários indicaram que não gostaram de um vídeo atribuindo uma classificação negativa. This is a core metric and is subject to the Deprecation Policy.
ações (métrica principal)
O número de vezes que os usuários compartilharam um vídeo usando o botão Share. Confira mais informações na Central de Ajuda do YouTube. This is a core metric and is subject to the Deprecation Policy.
subscribers_gained (métrica principal)
O número de vezes que os usuários se inscreveram em um canal. This is a core metric and is subject to the Deprecation Policy.

Os canais podem ganhar ou perder inscritos em vários lugares, incluindo a página de exibição de vídeos, a página do canal e o guia que aparece na página inicial do YouTube. Para identificar o número de novos inscritos em um canal que não se inscreveram pela página de exibição de um vídeo, um relatório básico de atividade do usuário contém uma linha que não especifica um valor de dimensão video_id. Essa linha também especifica um valor para a métrica subscribersLost, mas não especifica valores para outras métricas.
subscribers_lost (métrica principal)
O número de vezes que os usuários cancelaram a inscrição em um canal. This is a core metric and is subject to the Deprecation Policy.

Os dados dessa métrica são informados de maneira semelhante à métrica subscribers_gained. Para identificar o número de usuários que cancelaram a inscrição, mas não na página de exibição de um vídeo, um relatório básico de atividade do usuário contém uma linha que não especifica um valor de dimensão video_id. Essa linha também especifica um valor para a métrica subscribers_gained, mas não especifica valores para outras métricas.
videos_added_to_playlists
O número de vezes que os vídeos foram adicionados a playlists do YouTube. Os vídeos podem ter sido adicionados à playlist do proprietário ou a playlists de outros canais.

O valor da métrica inclui o número de vezes que os vídeos foram adicionados a playlists padrão, como "Assistir mais tarde". No entanto, ela não conta as playlists para as quais um vídeo é adicionado automaticamente, como a playlist de envios de um canal ou o histórico de exibição de um usuário.

Essa métrica retorna um número absoluto, o que significa que, se um usuário adicionar um vídeo a uma playlist, removê-lo e adicioná-lo novamente, o valor da métrica vai refletir o vídeo sendo adicionado à playlist duas vezes. Os dados dessa métrica não estão disponíveis para datas anteriores a 1º de outubro de 2014.
videos_removed_from_playlists
O número de vezes que os vídeos foram removidos de playlists do YouTube. Os vídeos podem ter sido removidos da playlist do proprietário ou de outras playlists de outros canais.

O valor da métrica inclui o número de vezes que os vídeos foram removidos de playlists padrão, como a "Assistir mais tarde".

Essa métrica retorna um número absoluto, ou seja, se um usuário adicionar um vídeo a uma playlist, remover, adicionar novamente e remover de novo, o valor da métrica vai refletir que o vídeo foi removido da playlist duas vezes. Os dados dessa métrica não estão disponíveis para datas anteriores a 1º de outubro de 2014.

Métricas de playlists

Os relatórios de playlist contêm dois tipos de métricas que explicam como os espectadores interagem com os vídeos em uma playlist:

  • As métricas agregadas de vídeo mostram a atividade do usuário e as métricas de impressões que são agregadas para todos os vídeos da playlist que também pertencem ao canal que a hospeda. As métricas de vídeos de outros canais não são computadas na agregação. Como resultado, se um canal criar uma playlist que contém apenas vídeos de outros canais, os relatórios dessas playlists não vão fornecer valores para essas métricas.

    Consulte as seções Métricas de visualização e Métricas de tempo de exibição deste documento para ver as definições das métricas de vídeo agregadas com suporte.

  • As métricas na playlist refletem a atividade e o engajamento do usuário no contexto da página da playlist. Essas métricas incluem as visualizações de todos os vídeos da playlist, independentemente de qual canal os possui, mas só contam as visualizações que ocorreram no contexto da playlist.

A maioria das métricas a seguir são de playlist. As métricas restantes na lista, como a playlistSaves, são sobre as interações do usuário com a playlist em si, e não com os vídeos dela. Por isso, essas métricas não são caracterizadas como métricas de vídeo agregadas ou de playlist.

playlist_starts
O número de vezes que os espectadores iniciaram a reprodução de uma playlist. Essa métrica inclui apenas as visualizações de playlist que ocorreram na Web.
playlist_saves_added (somente compatível com a API YouTube Reporting)
O número de vezes que os usuários salvaram uma playlist. Acesse a Central de Ajuda do YouTube para mais informações sobre as playlists salvas. Essa métrica retorna um número absoluto, ou seja, se um usuário salvar uma playlist, removê-la da lista de playlists salvas e salvá-la novamente, o valor da métrica vai refletir duas playlists salvas.
playlist_saves_removed (somente compatível com a API Reporting do YouTube)
O número de vezes que os usuários removeram a playlist das listas de músicas salvas. Essa métrica retorna um número absoluto, ou seja, se um usuário salvar uma playlist, removê-la da lista de playlists salvas, salvá-la de novo e removê-la de novo, o valor da métrica vai refletir duas playlists salvas sendo removidas.

Métricas de anotações

annotation_impressions
O número total de impressões de anotação.
annotation_clickable_impressions
O número de anotações que apareceram e puderam ser clicadas.
annotation_clicks
O número de anotações clicadas.
annotation_click_through_rate (métrica principal)
A proporção de anotações clicadas pelos espectadores em relação ao número total de impressões de anotações clicáveis. This is a core metric and is subject to the Deprecation Policy. A Central de Ajuda do YouTube tem mais informações sobre como criar anotações e como usar anotações de link.
annotation_closable_impressions
O número de anotações que apareceram e puderam ser fechadas.
annotation_closes
O número de anotações fechadas.
annotation_close_rate (métrica principal)
A proporção de anotações que os espectadores fecharam em relação ao número total de impressões de anotações. This is a core metric and is subject to the Deprecation Policy.

Métricas do card

A Central de Ajuda do YouTube tem instruções mais detalhadas sobre como adicionar cards aos seus vídeos e o relatório de cards do YouTube Analytics.

card_impressions
O número de vezes que os cards foram exibidos. Quando o painel de cards é aberto, uma impressão é registrada para cada card do vídeo.
card_clicks
O número de vezes que os cards foram clicados.
card_click_rate
A taxa de cliques em cards, que é calculada como a proporção entre cliques e impressões de cards.
card_teaser_impressions
O número de vezes que os teasers de card foram exibidos. Uma visualização de vídeo pode gerar várias impressões de teaser.
card_teaser_clicks
O número de cliques nos teasers de card. Os cliques no ícone do card são atribuídos ao último teaser mostrado ao usuário.
card_teaser_click_rate
A taxa de cliques em teasers de card, que é calculada como a proporção de cliques em teasers de card em relação ao número total de impressões de teasers de card.

Métricas da tela final

As telas finais são elementos que aparecem nos últimos 5 a 20 segundos de um vídeo para promover seu conteúdo, canal e sites. A Central de Ajuda do YouTube contém instruções mais detalhadas sobre como adicionar telas finais aos seus vídeos e o relatório de telas finais do YouTube Analytics.

end_screen_element_impressions
O número de elementos da tela final que foram exibidos. Uma impressão é registrada para cada elemento da tela final que aparece.
end_screen_element_clicks
O número de vezes que os elementos da tela final receberam cliques.
end_screen_element_click_rate
A taxa de cliques nos elementos da tela final, que é calculada como a proporção entre os cliques e as impressões dos elementos da tela final.

Métricas de retenção de público

audience_retention_percentage
A proporção absoluta de espectadores assistindo o vídeo no ponto especificado. A proporção é calculada comparando o número de vezes que uma parte de um vídeo foi assistida com o número total de visualizações do vídeo. A dimensão elapsed_video_time_percentage identifica a parte do vídeo a que a métrica corresponde.

Uma parte de um vídeo pode ser assistida mais de uma vez (ou nem mesmo ser assistida) em uma determinada visualização. Por exemplo, se os usuários retrocederem e assistirem a mesma parte de um vídeo várias vezes, a proporção absoluta dessa parte do vídeo poderá ser maior que 1.

Os exemplos a seguir ilustram como o valor é calculado:
  • Um vídeo de um minuto é assistido 100 vezes. Metade dos espectadores para de assistir após 15 segundos, e o restante assiste o vídeo inteiro. Nenhum dos espectadores assiste nenhuma parte do vídeo mais de uma vez. Nesse caso, o valor dessa métrica seria 1 para os intervalos de tempo no primeiro trimestre do vídeo e 0.50 para o restante do vídeo.
  • Um vídeo de um minuto é assistido 100 vezes. Todos os espectadores assistem o vídeo inteiro, mas 20 deles assistem até a marca de 45 segundos, depois pulam para a marca de 30 segundos e assistem o restante do vídeo. Nesse caso, o valor da métrica seria 1 para os intervalos de tempo no primeiro semestre ou no último trimestre do vídeo. No entanto, o valor seria 1.2 para os intervalos de tempo no terceiro trimestre do vídeo, já que 100% dos espectadores assistiram esse trecho do vídeo, mas 20% deles assistiram o trecho duas vezes.

Métricas de cancelamento de assinatura

membershipsCancellationSurveyResponses
O número de pesquisas concluídas por usuários do YouTube que cancelaram a assinatura do canal especificado durante o período do relatório.

Métricas de receita estimada

Observação:as métricas de receita estimada estão sujeitas a ajustes no final do mês e não incluem a publicidade vendida ou veiculada por parceiros. Consulte a Central de Ajuda do YouTube para mais informações e notas sobre os valores de receita estimados.

A API YouTube Reporting informa todos os valores estimados de receita e ganhos em USD.
estimated_partner_revenue (métrica principal)
A receita líquida total estimada de todas as origens de publicidade vendidas pelo Google e de origens não publicitárias para o período e a região selecionados.
estimated_partner_ad_revenue
A receita líquida total estimada de todas as fontes de publicidade vendidas pelo Google para o período e a região selecionados.

As métricas de receita estimada estão sujeitas a ajustes no final do mês e não incluem publicidade vendida ou veiculada por parceiros.
estimated_partner_ad_auction_revenue (somente compatível com a API YouTube Reporting)
O total de ganhos estimados (receita líquida) com a publicidade vendida em leilões pelo Google AdSense no período e na região selecionados. Essa métrica era chamada de estimated_partner_ad_sense_revenue.
estimated_partner_ad_reserved_revenue (somente compatível com a API Reporting do YouTube)
O total de ganhos estimados (receita líquida) da publicidade vendida com reserva pelo DoubleClick (DCLK) e outras origens vendidas pelo YouTube. Essa métrica era chamada de estimated_partner_double_click_revenue.
estimated_partner_red_revenue (somente compatível com a API Reporting do YouTube)
O total de ganhos estimados (receita líquida) das assinaturas do YouTube Premium (antes conhecido como YouTube Red).
estimated_partner_transaction_revenue (somente compatível com a API Reporting do YouTube)
A receita total estimada de transações, como conteúdo pago e financiamento de fãs, menos os reembolsos cobrados pelo parceiro.

Métricas de desempenho de anúncios

estimated_youtube_ad_revenue
A receita bruta estimada, em USD, de todos os anúncios vendidos pelo Google ou pelo parceiro do DoubleClick no período e na região selecionados. A receita bruta está sujeita a ajustes mensais e não inclui anúncios apresentados por parceiros. Não confunda receita bruta com receita estimada ou líquida, que considera sua participação na propriedade e os contratos de participação na receita.
estimated_cpm
A receita bruta estimada por mil impressões de anúncios.
ad_impressions
O número de impressões de anúncios verificadas veiculadas.
estimated_monetized_playbacks
O número de vezes que um espectador reproduziu seu vídeo e recebeu pelo menos uma impressão de anúncio. A reprodução monetizada é contabilizada se um anúncio precedente for exibido ao espectador e este cancelar a exibição do anúncio antes de seu vídeo começar. O erro estimado esperado para este valor é de cerca de 2%.
estimated_playback_based_cpm
A receita bruta estimada por mil reproduções.